The following documentation contains test scripts
and expected results for validating the CDISC Builder
tool. Do the following to verify proper
installation:
-
Perform each test by performing the steps specified
by the instructions.
- Evaluate the results of each step by comparing
them with results described in the Documentation
column.
Instructions
1
The following instructions are accomplished through
Windows Explorer.
- Navigate to
the validation "saspgm" directory.
- Right mouse
click on the contents1.sas program and select "Batch
Submit".
- Open the
contents1.log in a text editor.
- Verify that
there are following error messages.
ERROR: [contents] is missing required parameter INDATA.
ERROR: [contents] contains an invalid libname specification for: invalid
ERROR: [contents] was unable to find data data.invalid specified by parameter
INDATA.
Instructions
2
The following instructions are accomplished through
Windows Explorer.
- Navigate to
the validation "saspgm" directory.
- Open the
contents2.sas program in a text editor.
- Modify the
output path so it reflects the current "saspgm"
directory.
- Save and
close the program.
- Right mouse
click on the program and select "Batch Submit".
- In the
content2a.html, only two datasets "ae" and
"dm" are documented..
- In the
content2b.html, all datasets in the library data are
documented.
Instructions
3
The following instructions are accomplished through
Windows Explorer.
- Navigate to
the validation "saspgm" directory.
- Right mouse
click on the contents1.sas program and select "Batch
Submit".
- Verify that
there is no output html file created.
- Open the
contents3.log in a text editor.
- Verify that
there are following error messages.
ERROR: [contents] contains a report type (REPTYPE) specification.
NOTE: Valid report type include: both, contents or print.
Instructions
4
The following instructions are accomplished through
Windows Explorer.
- Navigate to
the validation "saspgm" directory.
- Open the
contents4.sas program in a text editor.
- Modify the
output path so it reflects the current "saspgm"
directory.
- Save and
close the program.
- Right mouse
click on the program and select "Batch Submit".
- In the
content4a.html, verify that the dataset ae has been
documented by both proc print and proc contents..
- In the
content4b.html, verify that the dataset ae has been
documented by only proc contents.
- In the
content4c.html, verify that the dataset ae has been
documented by only proc print.
Instructions
5
The following instructions are accomplished through
Windows Explorer.
- Navigate to
the validation "saspgm" directory.
- Open the
contents5.sas program in a text editor.
- Replace the
following part of the output parameters so it reflects
your current path of "saspgm" directory.
"d:\My Projects\cdiscbuilder\testing\saspgm".
- Right mouse
click on the contents5.sas program and select "Batch
Submit".
- Verify that
there is no output html file created.
- Open the
contents5.log in a text editor.
- Verify that
there are following error messages.
ERROR: [contents] the output file path does not exist.
ERROR: [contents] the output file name is invalid.
ERROR: [contents] the output file name is invalid.
ERROR: [contents] the output file path is missing.
Instructions
6
The following instructions are accomplished through
Windows Explorer.
- Navigate to
the validation "saspgm" directory.
- Open the
contents6.sas program in a text editor.
- Modify the
output path so it reflects the current "testing"
directory.
- Save and
close the program.
- Right mouse
click on the program and select "Batch Submit".
- Verify that
it generates a contents.html file in the current "saspgm"
directory.
- Verify that
it generates a contents6.html in the validation
"testing" directory.
- Verify that
these two report files are similar to each other.
Instructions
7
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Replace
the current path in the Source Data field with the current
path of the validation "data" directory
and hit Enter.
-
Verify
that the dataset list is updated with list of datasets
from the "data" directory.
-
Enter
the path of the sub-folder "contents" of the
validation "data" directory and press Enter.
-
Verify
that all the datasets in the selected folder are listed in
the dataset list.
-
Enter
a path which point to an empty directory and hit Enter.
-
Verify
that the dataset list is empty.
-
Enter
a path which does not exist and press Enter.
-
Verify
that there is a dialog displayed with the message
"WARNING: Source Data does not exist.".
-
Click
on the OK button to close the message box.
-
Click
on the Cancel button to exit.
Instructions
8
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Click
on the "..." button next to the Source Data
field.
-
Verify
that the "Select" dialog is opened.
-
Navigate
to the validation "data" directory and click OK.
-
Verify
that the path of the "data" directory is
displayed in the Source Data field.
-
Verify
that all datasets in the selected "data"
directory are displayed in the "Data Sets" list.
-
Click
on the "..." button to open the
"Select" dialog.
-
Navigate
to an empty directory and click on the OK button.
-
Verify
that the Source Data has been updated with the selected
path.
-
Verify
that the dataset list has been updated.
-
Open
the "Select" dialog again.
-
Navigate
to the sub-folder "contents" of "data"
directory.
-
Click
on the Cancel button.
-
Verify
that the Source Data and the dataset list have not been
changed.
-
Click
on the Cancel button to exit.
Instructions
9
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Click
on the "..." button to open the
"Select" dialog.
-
Navigate
to the sub-folder "contents" of the validation
"data" directory and click on the OK button.
-
Click
on the Select All button next to the "Data Set"
list.
-
Verify
that all the datasets in the list are selected.
-
Click
on the Select All button again.
-
Verify
that all the datasets in the list are de-selected.
-
Click
on the Cancel button to exit.
Instructions
10
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Remove
current path from Source Data field and hit Enter.
-
Click
on the OK button.
-
Verify
that there is a dialog displayed with the message
"WARNING: The field (Source Data) contains a missing
value.".
-
Close
the message box.
-
Click
on the Cancel button to exit.
Instructions
11
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Enter
a path that does not exist into the Source Data field.
-
Click
on the OK button.
-
Verify
that there is a dialog box displayed with the message
"WARNING: Source Data does not exist.".
-
Click
on the OK button to close the message box.
-
Click
on the Cancel button to close the CONTENTS dialog.
Instructions
12
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Click
on the "..." button to open the
"Select" dialog.
-
Navigate
to the sub-folder "contents" of the validation
"data" directory and click on the OK button.
-
Click
on the Select All button next to the "Data Set"
list.
-
Enter
a new path into Source Data but do not press Enter.
-
Click
on the OK button.
-
Verify
that there is a dialog displayed with the message
"WARNING: You have chosen a new library path without
refreshing. Please click on the text box and hit enter to
refresh.".
-
Click
on the OK button to close the message dialog box.
-
Click
on the Cancel button to close the CONTENTS dialog.
Instructions
13
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Click
on the "..." button to open the
"Select" dialog.
-
Navigate
to the sub-folder "contents" of the validation
"data" directory and click on the OK button.
-
De-select
all selected datasets in the dataset list if any.
-
Click
on the OK button.
-
Verify
that there is a dialog displayed with the message
"WARNING: There is no dataset selected.".
-
Click
on the OK button to close the message box.
-
Click
on the Cancel button to close the CONTENTS dialog.
Instructions
14
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Click
on the "..." button to open the
"Select" dialog.
-
Navigate
to the sub-folder "contents" of the validation
"data" directory and click on the OK button.
-
Click
on the Select All button to select all datasets in the
list.
-
Remove
the current value of the Output File field.
-
Click
on the OK button.
-
Verify
that there is a dialog displayed with the message
"WARNING: The field (Output File) contains a missing
value.".
-
Click
on the OK button to close the message box.
-
Click
on the Cancel button to close the Contents dialog.
Instructions
15
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Click
on the "..." button to open the
"Select" dialog.
-
Navigate
to the sub-folder "contents" of the validation
"data" directory and click on the OK button.
-
Click
on the Select All button to select all datasets in the
list.
-
Enter
"d:\My
Projects\cdiscbuilder\testing\saspgm\invalid\contents.html"
into the Output File field.
-
Replace
"d:\My Projects\cdiscbuilder\testing\saspgm"
with the path of the validation "saspgm"
directory in your pc.
-
Click
on the OK button.
-
Verify
that there is a dialog displayed with the message
"WARNING: The output path does not exist.".
-
Click
on the OK button to close the message box.
-
Click
on the Cancel button to close the Contents dialog.
Instructions
16
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Click
on the "..." button to open the
"Select" dialog.
-
Navigate
to the sub-folder "contents" of the validation
"data" directory and click on the OK button.
-
Click
on the Select All button to select all datasets in the
list.
-
Enter
"d:\My Projects\cdiscbuilder\testing\saspgm\contents.invalid"
into the Output File field.
-
Replace
"d:\My Projects\cdiscbuilder\testing\saspgm"
with the path of the validation "saspgm"
directory in your pc.
-
Click
on the OK button.
-
Verify
that there is a dialog displayed with the message
"WARNING: The output file name is invalid".
-
Click
on the OK button to close the message box.
-
Click
on the Cancel button to close the Contents dialog.
Instructions
17
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Click
on the "..." button to open the
"Select" dialog.
-
Navigate
to the sub-folder "contents" of the validation
"data" directory and click on the OK button.
-
Click
on the Select All button to select all datasets in the
list.
-
Enter
"contents.html" into the Output File field.
-
Click
on the OK button.
-
Verify
that there is a dialog displayed with the message
"WARNING: The output path is missing".
-
Click
on the OK button to close the message box.
-
Click
on the Cancel button to close the Contents dialog.
Instructions
18
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Click
on the "..." button to open the
"Select" dialog.
-
Navigate
to the sub-folder "contents" of the validation
"data" directory and click on the OK button.
-
Click
on the Select All button to select all datasets in the
list.
-
Enter
"d:\My Projects\cdiscbuilder\testing\saspgm\"
into the Output File field.
-
Replace
"d:\My Projects\cdiscbuilder\testing\saspgm"
with the current path of the validation "saspgm"
directory in your pc.
-
Click
on the OK button.
-
Verify
that there is a dialog displayed with the message
"WARNING: The output file name is missing.".
-
Click
on the OK button to close the message box.
-
Click
on the Cancel button to close the Contents dialog.
Instructions
19
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Click
on the "..." button to open the
"Select" dialog.
-
Navigate
to the sub-folder "contents" of the validation
"data" directory and click on the OK button.
-
Click
on the Select All button to select all datasets in the
list.
-
Enter
"d:\My Projects\cdiscbuilder\testing\contents19a.html"
into the Output File field.
-
Replace
"d:\My Projects\cdiscbuilder\testing" with the
current path of the validation "testing"
directory in your pc.
-
Click
on the OK button.
-
Verify
that it generates an html file named
"contents19a.html" in the validation
"testing" directory.
-
Click
on the "..." button next to the Output File
field.
-
Verify
that it opens the "Save As" dialog.
-
Navigate
to the validation "saspgm" directory and save
the file under the name "contents19b.html".
-
Click
on the OK button.
-
Verify
that it generates an html file named
"contents19b.html" in the validation "saspgm"
directory.
-
Verify
that these two files are similar to each other.
-
Click
on the Cancel button to close the Contents dialog.
Instructions
20
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Click
on the "..." button to open the
"Select" dialog.
-
Navigate
to the sub-folder "contents" of the validation
"data" directory and click on the OK button.
-
Click
on the Select All button to select all datasets in the
list.
-
Click
on the Save Code button.
-
Verify
that it opens the Save Code dialog.
-
In
the Save Code dialog, click on the "..." button
next to the Path field.
-
Verify
that the "Select" dialog is opened.
-
Navigate
to the "saspgm" directory and click on the OK
button.
-
Enter
"contents" into the File name field.
-
Click
on the OK button.
-
Verify
that it creates a sas program named "contents.sas"
in the "saspgm" directory and open it in the
View Code dialog.
-
Click
on the Back button to go back to the Contents dialog.
-
Click
on the Cancel button to close the Contents dialog.
Instructions
21
The following instructions are accomplished through
Windows Explorer.
-
Navigate
to the validation "saspgm" directory.
-
Right
mouse click on the contentsgui.sas program and select
"Batch Submit".
-
Verify
that the CONTENTS dialog is opened.
-
Click
on the "..." button to open the
"Select" dialog.
-
Navigate
to the sub-folder "contents" of the validation
"data" directory and click on the OK button.
-
Click
on the Select All button to select all datasets in the
list.
-
Select
"PROC PRINT" from the Report Type pull-down
list.
-
Change
the default output file name from "contents.html"
to "contents21a.html".
-
Click
on the OK button.
-
Verify
that it generates an html file named
"contents21a.html" in default directory.
-
Verify
that all datasets have been documented by proc print only.
-
Select
"PROC CONTENTS" from the Report Type pull-down
list.
-
Change
the default output file name from
"contents21a.html" to
"contents21b.html".
-
Click
on the OK button.
-
Verify
that it generates an html file named
"contents21b.html" in default directory.
-
Verify
that all datasets have been documented by proc contents
only.
-
Select
"BOTH" from the Report Type pull-down list.
-
Change
the default output file name from
"contents21b.html" to
"contents21c.html".
-
Click
on the OK button.
-
Verify
that it generates an html file named
"contents21c.html" in default directory.
-
Verify
that all datasets have been documented by both proc
contents and proc print.
-
Click
on the Cancel button to close the Contents dialog.
Instructions 22
The following instructions are accomplished through
Windows Explorer.
- Navigate to
the sub-directory "contents" of the
"data" directory.
- Rename the
two files invalid1 and invalid2 to invalid1.sas7bdat and
invalid2.sas7bdat.
- Navigate to
the validation "saspgm" directory.
- Right mouse
click on the contents7.sas program and select "Batch
Submit".
- Verify that it creates a log file and a contents.html file into the
current "saspgm" directory.
- Open the
log file in a text editor.
- Verify that
there are following warning messages.
WARNING: [contents] was unable to access data invalid1
located at: d:\My Projects\SAS\CDISCBUILDER\testing\data\contents.
WARNING: [contents] was unable to access data invalid2
located at: d:\My Projects\SAS\CDISCBUILDER\testing\data\contents.
- Verify that
there is no error message.
- Close the
log file.
- Rename the
two file invalid1.sas7bdat and invalid2.sas7bdat back to
invalid1 and invalid2.
Instructions
23
The following instructions are accomplished through Windows
Explorer.
- Navigate to
the sub-directory "contents" of the
"data" directory.
- Rename the
two files invalid1 and invalid2 to invalid1.sas7bdat and
invalid2.sas7bdat.
- Navigate to
the validation "saspgm" directory.
- Right mouse
click on the contents7.sas program and select "Batch
Submit".
- Verify that
it only creates a log file.
- Open the
log file in a text editor.
- Verify that
there are following warning messages.
WARNING: [contents] was unable to access data data.invalid1
located at: d:\My Projects\SAS\CDISCBUILDER\testing\data\contents.
WARNING: [contents] was unable to access data data.invalid2
located at: d:\My Projects\SAS\CDISCBUILDER\testing\data\contents.
ERROR: [contents] there is no valid dataset specified.
- Close the
log file.
- Rename the
two file invalid1.sas7bdat and invalid2.sas7bdat back to
invalid1 and invalid2.
Instructions
24
The following instructions are accomplished through Windows
Explorer.
- Navigate to
the sub-directory "contents" of the
"data" directory.
- Rename the
two files invalid1 and invalid2 to invalid1.sas7bdat and
invalid2.sas7bdat.
- Navigate to
the validation "saspgm" directory.
- Right mouse
click on the contentsgui.sas program and select
"Batch Submit".
- Enter the
path of the "contents" directory into the Source
Data field and hit Enter.
- Select all
the datasets in the dataset list and click on the OK
button.
- Verify that
there is a dialog displayed with the message
"WARNING: unable to open datasets: INVALID1
INVALID2. These datasets will be excluded.'.
- Click on
the OK button to close the dialog box.
- Verify that
it creates the output html file under the selected path.
- Click on
the Cancel button to close the dialog.
- Rename the
two file invalid1.sas7bdat and invalid2.sas7bdat back to
invalid1 and invalid2.
Instructions
25
The following instructions are accomplished through Windows
Explorer.
- Navigate to
the sub-directory "contents" of the
"data" directory.
- Rename the
two files invalid1 and invalid2 to invalid1.sas7bdat and
invalid2.sas7bdat.
- Navigate to
the validation "saspgm" directory.
- Right mouse
click on the contentsgui.sas program and select
"Batch Submit".
- Enter the
path of the "contents" directory into the Source
Data field and hit Enter.
- Select
INVALID1 and INVALID2 from the dataset list and click on
the OK button.
- Verify that
there is a dialog displayed with the message
"WARNING: unable to open datasets: INVALID1
INVALID2. These datasets will be excluded.".
- Click on
the OK button to close the dialog box.
- Select only
INVALID1 from the dataset list and click on the OK button.
- Verify that
there is a dialog displayed with the message
"WARNING: unable to open dataset: INVALID1.
This dataset will be excluded.".
- Close the
message dialog box.
- Verify that
there is no output html file created.
- Click on
the Cancel button to close the dialog.
- Rename the
two file invalid1.sas7bdat and invalid2.sas7bdat back to
invalid1 and invalid2.
Instructions
26
The following instructions are accomplished through Windows
Explorer.
- Navigate to
the validation "saspgm" directory.
- Right mouse
click on the contentsgui.sas program and select
"Batch Submit".
- Enter the
path of the "contents" directory into the Source
Data field and hit Enter.
- From the
list of dataset, select DM, DS, and SU from the dataset
list.
- Select PROC
PRINT from the report type.
- Change the
output file name from contents.html to test.html.
- Click on
the Cancel button to close the dialog.
- Open the
Contents dialog again by submitting the contntsgui.sas
program.
- Verify that
the current Source Data field displays the path of
"contents" directory.
- Verify that
the DM, DS, and SU dataset are selected.
- Verify that
the current selected report type is PROC PRINT.
- Verify that
the output file name is test.html
- Click on
the Cancel button to exit.
Instructions
27
The following instructions are accomplished through Windows
Explorer.
- Navigate to
the validation "saspgm" directory.
- Right mouse
click on the contentsgui.sas program and select
"Batch Submit".
- Enter the
path of the "contents" directory into the Source
Data field and hit Enter.
- Select all
items from the list of datasets.
- Click on
the Cancel button to close the dialog.
- Rename the
directory "contents" to "contents1".
- Open the
Contents dialog again.
- Verify that
the path of the "saspgm" directory is displayed
in the Source Data field instead of the path of
"contents".
- Verify that
the "BOTH" has been selected as the default
report type.
- Verify that
the default output file is "contents.html" in
the Source Data directory.
- Close the
Contents dialog.
- Rename the
"contents1" directory back to
"contents".
Instructions
28
The following instructions are accomplished through Windows
Explorer.
- Navigate to
the validation "saspgm" directory.
- Right mouse
click on the contentsgui.sas program and select
"Batch Submit".
- Enter the
path of the "contents" directory into the Source
Data field and hit Enter.
- Select EX
and SU from the list of datasets.
- Click on
the Cancel button.
- Navigate to
the "contents" directory.
- Rename
"SU" dataset to "SU1".
- Open the
Contents dialog again.
- Verify that
the Source Data directory is "contents".
- Verify that
the first dataset in dataset list has been selected
instead of EX.
- Click on
the Cancel button to exit.
- Rename the
"SU1" dataset back to "SU".
Instructions 29
The following instructions are accomplished through Windows
Explorer.
- Navigate to the "testing\data\contents" directory.
- Rename the file "grades" into "grades.sas7bdat".
- Navigate to the validation "saspgm" directory.
- Right mouse click on the contentsgui.sas program and
select "Batch Submit".
- Click on the "..." button next to the Source Data field
to open the Select dialog.
- Navigate to the "testing\data\contents" directory and
click OK to select.
- Click on the Select All button to select all the
datasets in the Dataset list.
- Click on the Preview button.
- Verify that there is a screen with a progress bar
showing the status of previewing selected datasets.
- Verify that there is a dialog box displayed with the
message "WARNING: the following dataset contains
user-defined format(s): GRADES.".
- Click on the OK button to close the warning message box.
- Verify that there is a Result Status screen displayed
with the result of evaluating the log file.
- Click "< Back" to close the Result Status screen.
- Verify that an html file is opened with 100 first
observations of each datasets.
- Verify that you still see the observation of dataset
GRADES.
- Click on the Cancel button to exit.
- Rename the file "grades.sas7bdat" to "grades".
Instructions 30
The following instructions are accomplished through Windows
Explorer.
- Navigate to the "testing\data\contents" directory.
- Rename the file "grades"
to "grades.sas7bdat".
- Navigate to the validation "saspgm" directory.
- Right mouse click on the contentsgui.sas program and
select "Batch Submit".
- Click on the "..." button next to the Source Data field
to open the Select dialog.
- Navigate to the "testing\data\contents" directory and
click OK to select.
- Click on the Select All button to select all the
datasets in the Dataset list.
- Click on the OK button.
- Verify that there is a progress bar displayed with the
status of generating output html file.
- Verify that there is a Result Status screen opened with
the result of evaluating the log.
- Click on the "Back" button to close the Result Status
screen.
- Click on the Cancel button to exit.
For more information, please contact MXI
.
|